home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / infosearch / ch2.z / ch2
Text File  |  2001-04-17  |  19KB  |  392 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information that is supplemental to the
  11.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed
  12.        here is product-specific; use it with the Installation Guide
  13.        to install this product.
  14.  
  15.        2.1  _I_n_f_o_S_e_a_r_c_h__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        The InfoSearch product includes these subsystems:
  18.  
  19.        _i_n_f_o_s_e_a_r_c_h._b_o_o_k_s._h_e_l_p         Information Searching Help
  20.  
  21.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._b_o_o_k_s        Search Index for Online Books
  22.                                      and Help
  23.  
  24.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._m_a_n          Search Index for Man Pages
  25.  
  26.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._r_e_l_n_o_t_e_s     Search Index for Release Notes
  27.  
  28.        _i_n_f_o_s_e_a_r_c_h._m_a_n._e_o_e            Information Searching Manual
  29.                                      Pages
  30.  
  31.        _i_n_f_o_s_e_a_r_c_h._m_a_n._r_e_l_n_o_t_e_s       Information Searching Release
  32.                                      Notes
  33.  
  34.        _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e            Information Searching Base
  35.                                      Environment
  36.  
  37.        _i_n_f_o_s_e_a_r_c_h._s_w._e_o_e             Information Searching
  38.                                      Execution Environment (client)
  39.  
  40.        _i_n_f_o_s_e_a_r_c_h._s_w._s_e_r_v_e_r          Information Searching Server
  41.                                      Environment
  42.  
  43.  
  44.        2.2  _I_n_f_o_S_e_a_r_c_h__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  45.  
  46.        This section lists the subsystems (and their sizes) of the
  47.        InfoSearch software.
  48.  
  49.        You can use the software installation instructions in the
  50.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e to install this product.
  51.        If you are installing this software for the first time, the
  52.        default subsystems are installed if you click the _I_n_s_t_a_l_l
  53.        _A_u_t_o_m_a_t_i_c_a_l_l_y button.  To install a different set of
  54.        subsystems, click the _C_u_s_t_o_m_i_z_e _I_n_s_t_a_l_l_a_t_i_o_n button and make
  55.        your new selections.  Then click the _S_t_a_r_t button to launch
  56.        the installation.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        Note:  The listed subsystem sizes are approximate. Refer to
  75.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  76.               on finding exact sizes.
  77.  
  78.        Subsystem Name                      Subsystem Size
  79.                                            (Kilobytes)
  80.        _i_n_f_o_s_e_a_r_c_h._b_o_o_k_s._h_e_l_p (_d_e_f_a_u_l_t)           580
  81.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._b_o_o_k_s                  19100*
  82.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._m_a_n                    20356*
  83.        _i_n_f_o_s_e_a_r_c_h._i_n_d_e_x._r_e_l_n_o_t_e_s                1224*
  84.        _i_n_f_o_s_e_a_r_c_h._m_a_n._e_o_e (_d_e_f_a_u_l_t)               48
  85.        _i_n_f_o_s_e_a_r_c_h._m_a_n._r_e_l_n_o_t_e_s (_d_e_f_a_u_l_t)          36
  86.        _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e (_d_e_f_a_u_l_t)              604
  87.        _i_n_f_o_s_e_a_r_c_h._s_w._e_o_e (_d_e_f_a_u_l_t)               248
  88.        _i_n_f_o_s_e_a_r_c_h._s_w._s_e_r_v_e_r (_d_e_f_a_u_l_t)           1716
  89.  
  90.  
  91.  
  92.        * Approximate subsystem size. Index information from files
  93.        not loaded on the system disk will be removed from the index
  94.        and those files not found in the index that reside on the
  95.        local system will be added to the index. This will occur at
  96.        system reboot time.
  97.  
  98.  
  99.  
  100.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  101.  
  102.        All of the subsystems for InfoSearch can be installed using
  103.        IRIX.  You do not need to use the miniroot. Refer to the
  104.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  105.        instructions.
  106.  
  107.  
  108.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  109.  
  110.        Your workstation must be running IRIX 6.5 or greater in
  111.        order to use this release of InfoSearch.
  112.  
  113.        The infosearch.index subsystems require that the
  114.        sgsearch.sw.base subsystem is installed.
  115.  
  116.        infosearch.sw.eoe requires that webviewer.sw.eoe and
  117.        websupport_eoe.sw.lib are installed.
  118.  
  119.        In order to view the Online books, infosearch.sw.server
  120.        requires that dynaweb.sw.eoe be installed.
  121.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                   - 3 -
  132.  
  133.  
  134.  
  135.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  136.  
  137.        InfoSearch is compatible with all supported forms of SGI
  138.        documentation.  Using a version 1.x InfoSearch client
  139.        application to access InfoSearch content from an InfoSearch
  140.        server that has been updated to version 2.x is _n_o_t
  141.        _s_u_p_p_o_r_t_e_d.
  142.  
  143.  
  144.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  145.  
  146.  
  147.  
  148.        2.6.1  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  149.  
  150.        Changing /usr/lib/infosearch/C/infosrch.cfg to add new
  151.        document/information domains is not currently supported.
  152.  
  153.  
  154.        2.6.2  _I_n_f_o_S_e_a_r_c_h__S_e_r_v_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  155.  
  156.        Upon completion of the InfoSearch server installation
  157.        (infosearch.sw.server), a series of links are established
  158.        into what InfoSearch believes to be your HTTP (web) server's
  159.        default CGI (Common Gateway Interface) and document root
  160.        directories.
  161.  
  162.        The following commands are performed as part of the exit
  163.        operation following the install:
  164.  
  165.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////iiiinnnnffffoooossssrrrrcccchhhh....ccccggggiiii ////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn////iiiinnnnffffoooossssrrrrcccchhhh....ccccggggiiii
  166.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC  ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC
  167.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll
  168.            #### llllnnnn ----ssss ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////CCCC////iiiinnnnddddeeeexxxx....hhhhttttmmmmllll  ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////iiiinnnnddddeeeexxxx....sssshhhhttttmmmmllll
  169.  
  170.        These are necessary for InfoSearch to run properly. If your
  171.        HTTP (web) server's default CGI location _O_R your HTTP
  172.        server's document root differ from the defaults shown above
  173.        (/var/www/cgi-bin/; /var/www/htdocs/), please execute the
  174.        commands shown above (as root) from a shell with the correct
  175.        values substituted.
  176.  
  177.        In order to view the Online books and Help information,
  178.        infosearch.sw.server requires that dynaweb.sw.eoe be
  179.        installed.  Refer to the _D_y_n_a_w_e_b _r_e_l_e_a_s_e _n_o_t_e_s for the
  180.        proper setup and installation of that product.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                   - 4 -
  198.  
  199.  
  200.  
  201.        2.6.3  _S_e_t_t_i_n_g__u_p__a__L_o_c_a_l__I_n_f_o_S_e_a_r_c_h__S_e_r_v_e_r
  202.  
  203.        To create an InfoSearch server, install all the books, help
  204.        books, man pages and relnotes on the machine you wish to be
  205.        the server. To install all the documentation, follow this
  206.        procedure in inst(1M), for each CD:
  207.  
  208.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ****....mmmmaaaannnn....****
  209.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ****....bbbbooooooookkkkssss....****
  210.  
  211.        Next, install the following subsystems:
  212.  
  213.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....mmmmaaaannnn
  214.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....bbbbooooooookkkkssss
  215.            IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....iiiinnnnddddeeeexxxx....rrrreeeellllnnnnooootttteeeessss
  216.  
  217.        At this point, if the machine is not to be rebooted (which
  218.        triggers _s_g_i_n_d_e_x_A_d_m_i_n to be run automatically), then run
  219.        _s_g_i_n_d_e_x_A_d_m_i_n from a shell (as root):
  220.  
  221.            #### ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn ----uuuuppppddddaaaatttteeee
  222.  
  223.        See the next section for more details.
  224.  
  225.        The InfoSearch server and available content can now be
  226.        accessed via a web browser such as _n_e_t_s_c_a_p_e(1) (preferred
  227.        method) or via the InfoSearch client. Use the URL
  228.        http://<hostname>/infosearch/ where <hostname> is the name
  229.        of the server. To access the server from the InfoSearch
  230.        client, use the same designation, or simply the server name.
  231.  
  232.        If the indexes become damaged, they can be rebuilt from
  233.        scratch using the following command:
  234.  
  235.           #### ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn ----ffffoooorrrrcccceeee ----uuuuppppddddaaaatttteeee
  236.  
  237.        2.6.4  _s_g_i_n_d_e_x_A_d_m_i_n__a_n_d__M_a_i_n_t_a_i_n_i_n_g__a_n__I_n_f_o_S_e_a_r_c_h__D_a_t_a_b_a_s_e
  238.  
  239.        _s_g_i_n_d_e_x_A_d_m_i_n(1) is the utility program used to keep your
  240.        InfoSearch database(s) in sync. In other words, what is
  241.        installed on your system should match what is indexed and
  242.        referenced by the InfoSearch database(s).  The program
  243.        _s_g_i_n_d_e_x_A_d_m_i_n performs that function and can be run from the
  244.        command line, as root. See the _s_g_i_n_d_e_x_A_d_m_i_n(1) man page for
  245.        details.
  246.  
  247.        When your machine is rebooted, _s_g_i_n_d_e_x_A_d_m_i_n is run
  248.        automatically.  It checks to verify if new content has been
  249.        installed and updates your InfoSearch database(s) in the
  250.        background (running in the process queue under a very low
  251.        priority).
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                   - 5 -
  264.  
  265.  
  266.  
  267.        Note:  If you have installed or removed additional/optional
  268.               products that included documentation (man pages,
  269.               release notes or online books) and your machine has
  270.               not been rebooted, you may need to run _s_g_i_n_d_e_x_A_d_m_i_n
  271.               from the shell to put your InfoSearch database(s) in
  272.               sync with the content recently installed or removed
  273.               from your disk.
  274.  
  275.        InfoSearch attempts to make an educated guess at when
  276.        content may have been installed. It does a quick check of
  277.        the _i_n_s_t(1M) history file (/var/inst/hist) and compares it's
  278.        system modification date to the system modification date of
  279.        the InfoSearch index file(s). If the index files' date is
  280.        less than that of the _i_n_s_t(1M) history file, a warning
  281.        message will be printed on the main InfoSearch page when the
  282.        interface is invoked/accessed. This warning appears below
  283.        the search text field, and acts as a friendly reminder to
  284.        the administrator that _s_g_i_n_d_e_x_A_d_m_i_n may need to be run. An
  285.        example of this warning message follows:
  286.  
  287.            TTTThhhheeee sssseeeeaaaarrrrcccchhhhaaaabbbblllleeee iiiinnnnddddeeeexxxx ffffiiiilllleeeessss ffffoooorrrr tttthhhheeee ddddaaaattttaaaabbbbaaaasssseeeessss ffffoooouuuunnnndddd oooonnnn tttthhhhiiiissss sssseeeerrrrvvvveeeerrrr
  288.            mmmmaaaayyyy bbbbeeee oooouuuuttttddddaaaatttteeeedddd.... PPPPeeeerrrrhhhhaaaappppssss ttttrrrryyyy aaaannnnooootttthhhheeeerrrr sssseeeerrrrvvvveeeerrrr ((((tttteeeecccchhhhppppuuuubbbbssss....ssssggggiiii....ccccoooommmm)))) oooorrrr
  289.            uuuuppppddddaaaatttteeee yyyyoooouuuurrrr iiiinnnnddddeeeexxxx wwwwiiiitttthhhh ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn????
  290.  
  291.        If necessary, _s_g_i_n_d_e_x_A_d_m_i_n can be run (as root) from the
  292.        shell as follows:
  293.  
  294.            #### ////uuuussssrrrr////lllliiiibbbb////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////bbbbiiiinnnn////ssssggggiiiinnnnddddeeeexxxxAAAAddddmmmmiiiinnnn ----uuuuppppddddaaaatttteeee
  295.  
  296.        2.6.5  _F_i_l_e_s__N_o_t__L_i_s_t_e_d__b_y__'_v_e_r_s_i_o_n_s_'
  297.  
  298.        Local index files local<domain>.{ttl, dct, idx, inv} and the
  299.        table-of-contents (<domain>*.html) files are generated by
  300.        _s_g_i_n_d_e_x_A_d_m_i_n(1). See the FILES section of the
  301.        _s_g_i_n_d_e_x_A_d_m_i_n(1) man page for further details.
  302.  
  303.  
  304.        2.6.6  _E_r_r_o_r_s__A_c_c_e_s_s_i_n_g__t_h_e__S_e_r_v_e_r
  305.  
  306.        InfoSearch utilizes server-side parsed HTML (.shtml) files
  307.        upon startup. If your HTTP (web) server is not configured
  308.        properly to handle these types of files, you may see the
  309.        following error in the InfoSearch client application (or
  310.        your web browser):
  311.  
  312.            [[[[aaaannnn eeeerrrrrrrroooorrrr ooooccccccccuuuurrrrrrrreeeedddd wwwwhhhhiiiilllleeee pppprrrroooocccceeeessssssssiiiinnnngggg tttthhhhiiiissss ddddiiiirrrreeeeccccttttiiiivvvveeee]]]]
  313.  
  314.        One possible area to check is your server configuration
  315.        files. Examine the variable MaxThreads in the file
  316.        magnus.conf. The file may be found (for example) in
  317.        /usr/ns-home/httpd-<our_machine>/config or
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                   - 6 -
  330.  
  331.  
  332.  
  333.        /var/netscape/fasttrack/httpd-<our_machine>/config.  This
  334.        variable should be set to at least _4 for this operation to
  335.        function properly. You will need to restart your HTTP (web)
  336.        server after modifying this variable.
  337.  
  338.        Refer to your HTTP (web) server's documentation for details.
  339.  
  340.  
  341.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  342.  
  343.        After the software has been installed, you can access the
  344.        InfoSearch content as follows:
  345.  
  346.           %%%% iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh <<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>
  347.  
  348.        NNNNooootttteeee:::: As of release 3.x and beyond, the InfoSearch "client"
  349.        is a process that simply launches your desktop web-browser
  350.        (as specified in the Toolchest->Desktop->Customize-
  351.        >Utilities panel).
  352.  
  353.        A more direct approach is to use this command:
  354.  
  355.           %%%% <<<<wwwweeeebbbb____bbbbrrrroooowwwwsssseeeerrrr>>>> hhhhttttttttpppp::::////////<<<<hhhhoooossssttttnnnnaaaammmmeeee>>>>////iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh////
  356.  
  357.        Substitute your favorite HTTP (web) browser for
  358.        "<web_browser>" in the previous example. Substitute the name
  359.        of the server containing InfoSearch content for <hostname>
  360.        in both examples.
  361.  
  362.        Up-to-date content from SGI is always available at:
  363.        http://techpubs.sgi.com/.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.